Muovi il mouse sulla mappa
NAT (National Topography) RC/RA Italia รจ uno strumento professionale di visualizzazione, analisi e gestione delle reti nazionali italiane di telecomunicazioni DWDM. Progettato per ingegneri, tecnici e manager che operano nell'ambito delle infrastrutture di rete backbone (RC) e access (RA).
๐ NOVITร VERSIONE ULTIMATE (05/12/2025):
โ
Etichette Tipo Rete: Popup "Centrali Vicine" mostra tipo DB per ogni centrale
โข RC_Italia Core (rosso) - Centrale backbone
โข RA_Italia Aggregation (blu) - Centrale accesso
โข Aggregation โข Core (viola) - Centrale presente in entrambi
โ
Fix Toggle Evidenzia Nodi: Il toggle "Evidenzia Centrali Connesse" ora funziona con tutti i DB
โ
Database Multipli: Supporto completo per 3 database (RC, RA, RA+RC)
โ
Marker FLUO: Colori ultra-brillanti per selezioni da tabella
โ
Bottoni Colorati: Rosso (RC), Blu (RA), Viola (MERGED) con gradienti
โ
Tooltip Ottimizzati: Solo CLLI nella seconda riga, prioritร intelligente MERGED
โ
Tracker Ciano: Marker posizione aggiornato a #00ffff
โ
DB RA Default: Applicazione si apre con rete di accesso
Tipo: Rete backbone nazionale
Collegamenti: ~1.197 tra centrali principali
Nodi: ~806 centrali
Distanza: ~29.124 km
Colore Marker: ๐ด Rosso / ๐ Magenta FLUO (#ff0066)
Quando Usarlo: Pianificazione backbone, analisi long-haul, decisioni strategiche
Tipo: Rete di accesso locale
Collegamenti: ~6.187 collegamenti
Nodi: ~4.523 nodi
Distanza: ~15.842 km
Colore Marker: ๐ต Blu / ๐ Ciano FLUO (#00ddff)
Quando Usarlo: Pianificazione locale, analisi copertura access, collegamenti brevi
Tipo: Vista unificata backbone + access
Collegamenti: ~7.384 (con deduplicazione)
Nodi: ~5.329 (unione con identificazione duplicati)
Colore Marker: ๐ฃ Viola / ๐ฃ Magenta FLUO PURO (#ff00ff)
Prioritร Tooltip: BLU se presente in RA, ROSSO se solo in RC
Quando Usarlo: Analisi topologia completa, identificazione sovrapposizioni
๐ก Cambiare Database:
Usa i bottoni colorati nella sezione "๐พ Sorgente Database":
โข ๐ DB RA (BLU) โ Rete di accesso โญ DEFAULT
โข ๐ DB RC (ROSSO) โ Rete backbone
โข ๐ DB RA+RC (VIOLA) โ Vista combinata
Quando cambi database:
โ
Marker ridisegnati automaticamente
โ
Tooltip aggiornati con colori corretti
โ
Tabelle aggiornate
โ
Contatori ricalcolati
โ ๏ธ Selezioni azzerate (filtri mantenuti)
Dimensioni: 12px radius + 4px bordo nero (200% piรน grandi)
DB RC: ๐ Magenta FLUO #ff0066
DB RA: ๐ Ciano FLUO #00ddff
DB MERGED: ๐ฃ Magenta FLUO PURO #ff00ff โก (IL PIร BRILLANTE!)
Caratteristica: Impossibili da non notare sulla mappa!
Da Collegamenti: 8px, colori pieni (๐ด Rosso, ๐ต Blu, ๐ฃ Viola)
Default: 6px, trasparenti (opacity 0.4)
Tracker: ๐ง Ciano #00ffff, 24px (per "Centrali Vicine")
Prima riga: Nome + Checkmark โ (se selezionato) - COLORATO
Seconda riga: Solo CLLI in grassetto nero (๐ rimosso nome duplicato)
Terza riga: ๐ Zona + Regione
Quarta riga: ๐ Coordinate
Prima riga: ID collegamento - COLORATO
DB MERGED Prioritร :
โข ๐ต BLU se presente in RA o in entrambi i DB
โข ๐ด ROSSO se presente solo in RC
Tecnologia: Leaflet.js con layer OpenStreetMap
Zoom: 18 livelli (da vista nazionale a dettaglio stradale)
Prestazioni: Rendering ottimizzato per gestire 330+ collegamenti simultanei
Interattivitร : Pan, zoom, click su elementi, misurazione distanze
Filtro Stato (struttura presente ma non attiva in questa revisione): il modello dati supporta 5 stati operativi (ATTIVO, NON_ATTIVO, IN_ATTIVAZIONE, IN_VARIAZIONE, IN_REINSTRADAMENTO), ma per questa versione la sezione di filtro dedicata e la colorazione per stato sono volutamente disabilitate a causa di limitazioni nellโaggiornamento automatico dello stato dei collegamenti.
Filtro Area: 3 macro-aree geografiche (NORD, CENTRO, SUD)
Filtro Zona: 14 zone regionali dettagliate
Filtro Arco: Selezione per segmenti di rete specifici
Ricerca Testuale: Per ID collegamento, nome centrale, CLLI
Misura In Linea d'Aria: Calcolo Haversine per distanze geodetiche precise
Misura Stradale: Integrazione OSRM (Open Source Routing Machine) per percorsi reali
Precisione: Al metro per distanze aeree, routing ottimizzato per strade
Comparazione: Visualizzazione simultanea linea retta vs percorso stradale
Notifiche interne al tool: tutti i messaggi di avviso utilizzano ora un pop up HTML dedicato, visivamente allineato ai pulsanti DB (RA / RC / RA+RC) e non piรน le finestre di alert del browser.
Conferma operazioni pesanti: i bottoni "Tutti" nelle sezioni "๐ Collegamenti (Selezionabili e Sempre Visibili)" e "๐ Centrali / Nodi (Selezionabili e Sempre Visibili)" richiedono una conferma esplicita prima di selezionare l'intero dataset, per evitare attese eccessive durante la sincronizzazione mappa & tabelle.
Messaggi contestuali: gli avvisi riportano sempre il contesto (es. DB non caricato, nessun elemento selezionato, errori di copia negli appunti), per facilitare l'interpretazione rapida durante le attivitร di progettazione.
Algoritmo: Ricerca delle 3 centrali piรน vicine con calcolo real-time
Input: Coordinate GPS o indirizzo geocodificato
Output: Nome, CLLI, distanza aerea, percorso stradale con visualizzazione mappa
Use Case: Site survey, espansione rete, troubleshooting connettivitร
๐ Etichette Tipo Rete (05/12/2025):
Ogni centrale nel popup mostra ora il tipo di rete come prima riga:
โข RC_Italia Core - Centrale presente nel DB backbone
โข RA_Italia Aggregation - Centrale presente nel DB accesso
โข Aggregation โข Core - Centrale presente in entrambi i database
Forward Geocoding: Indirizzo โ Coordinate (powered by Nominatim/OpenStreetMap)
Reverse Geocoding: Coordinate โ Posizione mappa
Formati Supportati: DD (Decimal Degrees), DMS (Degrees Minutes Seconds)
Precisione: Fino a 6 decimali (ยฑ11 cm)
Modalitร Visualizzazione:
โข Mostra/Nascondi marker centrali
โข Mostra/Nascondi collegamenti non selezionati
โข Evidenziazione nodi connessi automatica
โข Colorazione stati con 5 codifiche
Selezione: Click su collegamenti per selezione/deselezione
Statistiche: Conteggio real-time collegamenti e distanze selezionate
Engine: OSRM (Open Source Routing Machine)
Database: OpenStreetMap con aggiornamenti continui
Visualizzazione: Linea blu continua per percorso stradale, linea rossa tratteggiata per distanza aerea
Popup Informativi: Click su linee per dettagli distanze
Posizione: Sia nella tabella Collegamenti che nella tabella Centrali/Nodi
Funzionalitร : Toggle per mostrare/nascondere solo gli elementi selezionati
Colore: Azzurro chiaro per facile identificazione
Uso: Filtraggio rapido per focus su subset specifici
Gli stati dei collegamenti sono visualizzati sia sulla mappa che nelle tabelle con codifica cromatica coerente:
NORD: Piemonte/Valle d'Aosta (PV), Lombardia (LO), Liguria (LI), Trentino/Veneto/Friuli (NE), Emilia Romagna (ER)
CENTRO: Toscana (TO), Marche/Umbria (MU), Lazio (RM), Abruzzo/Molise (AM)
SUD: Campania/Basilicata (CB), Puglia (PU), Calabria (CA), Sicilia (SI), Sardegna (SA)
Ogni zona ha un codice a due lettere per identificazione rapida. Le zone seguono i confini amministrativi regionali italiani per facilitร di riferimento e coordinamento con enti territoriali.
๐ก Best Practice Generale:
Inizia sempre una nuova sessione di lavoro con il bottone "๐ Reset All" per partire da una baseline pulita. Questo evita confusione da filtri applicati in sessioni precedenti.
Questa sezione รจ dedicata a chi necessita di una visione strategica della rete nazionale, deve monitorare KPI operativi, identificare criticitร topologiche e prendere decisioni informate su investimenti e pianificazione.
1. Coverage Nazionale:
โข 124 Centrali distribuite su 3 macro-aree
โข Densitร per area: applica filtro Area per valutare bilanciamento
โข Identificazione zone sotto-servite
2. Salute Operativa Rete:
โข % Collegamenti ATTIVI vs totale
โข Collegamenti in fase progettuale (IN_ATTIVAZIONE + IN_VARIAZIONE)
โข Collegamenti critici (NON_ATTIVO, IN_REINSTRADAMENTO)
3. Progetti in Corso:
โข Filtra per "IN_ATTIVAZIONE" โ vedi pipeline nuovi collegamenti
โข Filtra per "IN_VARIAZIONE" โ vedi upgrade/modifiche
โข Filtra per "IN_REINSTRADAMENTO" โ vedi ottimizzazioni routing
4. Distanze e Topologia:
โข 8.024,40 km totali di fibra/collegamenti
โข Usa "Selezione Attuale" per subset di interesse
โข Confronta distanze tra scenari alternativi
๐ Scenario 1: Report Trimestrale Stato Rete
Obiettivo: Generare snapshot operativo per board/stakeholders
Procedura:
1. Click "๐ Reset All" per baseline pulita
2. Osserva statistiche globali: 330 Collegamenti, 8.024 km
3. Filtra per "NON_ATTIVO" โ conta quanti link down
4. Filtra per "IN_ATTIVAZIONE" โ conta progetti in pipeline
5. Usa "๐บ๏ธ Zoom All" per vista geografica completa
6. Screenshot della mappa per allegato al report
7. Ripeti per ogni macro-area (NORD/CENTRO/SUD)
Output: Dashboard visuale + metriche quantitative
๐จ Scenario 2: Incident Management - Collegamento Critico Down
Obiettivo: Valutare impatto e identificare bypass
Procedura:
1. Ricerca collegamento in tabella (es: ID o nome centrali)
2. Click sul collegamento per zoom automatico sull'area
3. Osserva visivamente centrali adiacenti
4. Usa "๐ข Centrali Vicine" su centrale impattata
5. Identifica 2-3 percorsi alternativi possibili
6. Misura distanze con strumento ๐
7. Valuta fattibilitร e comunica al NOC
Output: Piano di contingenza rapido
๐ Scenario 3: Pianificazione Espansione - Nuova Area
Obiettivo: Decidere dove investire in nuove centrali
Procedura:
1. Filtra per Area di interesse (es: SUD)
2. Usa "๐บ๏ธ Zoom All" per visione completa area
3. Osserva densitร di nodi: zone "vuote" = opportunitร
4. Usa "Ricerca Indirizzo" per cittร target
5. Clicca "๐ข Centrali Vicine" per vedere distanze esistenti
6. Se distanze >50km = coverage gap identificato
7. Misura potenziali nuovi collegamenti con ๐
Output: Business case per nuova centrale
๐ฏ Scenario 4: Presentazione Commerciale a Cliente
Obiettivo: Mostrare capillaritร e affidabilitร rete
Procedura:
1. Filtra per Area/Zona del cliente
2. Seleziona solo collegamenti ATTIVI
3. Usa "Zoom Selezione" per focus su area cliente
4. Evidenzia ridondanza: mostra percorsi alternativi
5. Screenshot per slide deck
6. Mostra progetti IN_ATTIVAZIONE per roadmap futura
Output: Presentazione visual impattante
Obiettivo: Tracciare crescita e evoluzione rete nel tempo
Metodo: Confronta snapshot Rev7.x vs Rev6.x
โข Conta nuovi collegamenti aggiunti
โข Identifica collegamenti dismessi
โข Valuta crescita km fibra totali
โข Analizza shift geografico investimenti
Valore: ROI tracking, forecast budget futuro
Obiettivo: Trovare single points of failure nella topologia
Metodo:
โข Seleziona una zona strategica (es: RM per Lazio)
โข Conta quante centrali hanno solo 1-2 collegamenti
โข Verifica ridondanza: esistono percorsi alternativi?
โข Se centrale ha 1 solo link = SPOF identificato
Azione: Prioritizza investimento in ridondanza
Obiettivo: Valutare ROI per proposto nuovo link
Dati Necessari:
โข Distanza nuova tratta (usa ๐ sulla mappa)
โข Centrali attualmente servite da quella tratta
โข Traffic volume potenziale (dato esterno)
Calcolo Rough:
โข CAPEX fibra โ โฌ20.000-50.000/km (medio)
โข Latency risparmiata = (old_distance - new_distance) / 200.000 km/s
Decisione: Se riduzione latency >2ms E traffic >10Gbps โ probabile GO
Formula: Densitร = Numero Collegamenti / Numero Centrali
Valore Ideale: 2.5-3.5 (rete ben connessa con ridondanza)
NAT RC_Italia: 330/124 = 2.66 (buona densitร )
Uso: Valuta singole zone: se <2.0 = sotto-connessa
Definizione: % centrali con โฅ2 collegamenti
Come Calcolare:
1. Seleziona tutte le centrali
2. Per ognuna, conta collegamenti (visibile in lista)
3. Conta centrali con degree โฅ2
4. Resilience = (Centrali con โฅ2 link / Totale centrali) ร 100
Target: >85% per rete robusta
๐ก Pro Tips per Manager:
โข Usa bottone "Select" nelle tabelle per isolare subset di interesse
โข Combina filtri multipli: Area + Stato per analisi incrociate
โข Salva screenshot con timestamp per documentazione decisions
โข Condividi URL mappa con zoom/filtri applicati al team
โข Esporta coordinate centrali chiave per GIS/planning tools
Documentazione tecnica approfondita per progettisti di rete, ingegneri di sistema e architetti infrastrutturali. Include specifiche tecniche, formule di calcolo e procedure di verifica.
Campi Disponibili per Ogni Link:
โข id: Identificativo univoco numerico (integer)
โข from / from_id: ID centrale di partenza
โข to / to_id: ID centrale di arrivo
โข from_name / to_name: Nomi testuali centrali
โข distance_km: Distanza in km (float, precisione 2 decimali)
โข stato: Enum [ATTIVO, NON_ATTIVO, IN_ATTIVAZIONE, IN_VARIAZIONE, IN_REINSTRADAMENTO]
โข zona: Codice zona (string, 2 caratteri)
โข regione: Nome esteso regione
โข area: Enum [NORD, CENTRO, SUD]
โข arco: Segmento di rete (opzionale)
Formato Storage: Array JavaScript nativo per performance
Campi per Ogni Nodo:
โข id: Identificativo univoco (string/integer)
โข name: Nome completo centrale
โข clli: Common Language Location Identifier (standard ITU-T)
โข lat: Latitudine (float, formato Decimal Degrees, 6 decimali)
โข lon: Longitudine (float, formato Decimal Degrees, 6 decimali)
โข zona: Codice zona regionale
โข area: Macro-area di appartenenza
โข TipoSede: Classificazione sede (Tipo 1/2/3)
Precisione Coordinate: ยฑ11cm con 6 decimali
Uso: Calcolo distanza "as the crow flies" tra due punti su sfera
Formula Completa:
a = sinยฒ(ฮฯ/2) + cos(ฯ1) ร cos(ฯ2) ร sinยฒ(ฮฮป/2)
c = 2 ร atan2(โa, โ(1โa))
d = R ร c
Dove:
โข ฯ = latitudine (in radianti)
โข ฮป = longitudine (in radianti)
โข R = raggio terrestre = 6371 km
โข ฮฯ = ฯ2 โ ฯ1
โข ฮฮป = ฮป2 โ ฮป1
Errore: <0.5% per distanze <1000km
Implementazione: Funzione JavaScript nativa nell'applicazione
Engine: Open Source Routing Machine v5.x
Database: OpenStreetMap con update mensili
Algoritmo: Contraction Hierarchies per performance
Query: HTTP GET a endpoint OSRM pubblico
Response Time: <500ms tipico per query EU
Precisione: ยฑ2-5% vs distanze reali misurate
Limitazioni:
โข Solo strade carrozzabili (no sentieri, private roads in alcuni casi)
โข Route optimization basato su tempo, non shortest path puro
โข Puรฒ differire da GPS turn-by-turn moderni
Attivazione: Click icona ๐ in barra controlli mappa
Procedura:
1. Tool attivato: cursore cambia in crosshair
2. Click primo punto sulla mappa
3. Appare marker iniziale
4. Click secondo punto
5. Linea rossa tratteggiata collega i punti
6. Popup mostra distanza in km
7. Opzionale: click punti aggiuntivi per polilinea
Cancellazione: Click icona ๐๏ธ per rimuovere tutte le misure
Precisione: Equivalente a Haversine (ยฑ0.5%)
Limiti: No automatic snapping a nodi/link
Metodo:
1. Seleziona centrale A nella lista Centrali
2. Seleziona centrale B nella lista Centrali
3. Click collegamento che li unisce (se esiste)
4. Distanza mostrata in popup e in tabella
Alternativa per Centrali Non Direttamente Collegate:
โข Usa Ricerca Centrali Vicine da centrale A
โข Output include distanza a tutte le centrali limitrofe
โข Nessuna se B non รจ tra le top 3 โ usa ruler tool manuale
Formula Base:
Latency (ms) = (Distance km / Speed km/s) ร 1000
Velocitร Luce in Fibra:
โข Vuoto: c = 299.792 km/s
โข Fibra SMF (G.652): v โ 200.000 km/s (โ
c, indice rifrazione nโ1.5)
Esempio:
Distanza ROMA-MILANO โ 480 km (aerea)
Latency teorica = 480 / 200.000 ร 1000 = 2.4 ms
Latency Reale: +0.5-1ms per commutazione, repeater, connettori
Budget Link: Tipico RTT (Round Trip Time) = latency ร 2
Formula:
Attenuation (dB) = ฮฑ ร Distance (km) + Connectors + Splices
Valori Tipici:
โข Fibra SMF G.652 @ 1550nm: ฮฑ = 0.2-0.25 dB/km
โข Connettori: 0.3-0.5 dB ciascuno
โข Splice fusion: 0.05-0.1 dB ciascuno
Esempio ROMA-MILANO 480km:
Fibra: 480 ร 0.22 = 105.6 dB
Connettori (2): 2 ร 0.4 = 0.8 dB
Splice (10 ogni 50km): 10 ร 0.08 = 0.8 dB
Totale Link Budget: ~107 dB
Margin: Se Tx=+3dBm, Rx sensitivity=-30dBm โ disponibili 33dB โ NON sufficiente! โ Necessari amplificatori EDFA
Canali ITU-T G.694.1 C-band: 80 canali @ 50GHz spacing
Singolo Canale: 100 Gbps tipico (coherent optics)
Capacitร Totale Fibra: 80 ร 100 = 8 Tbps (8.000 Gbps)
Con Tecnologia Attuale (400G channels):
80 ร 400 = 32 Tbps potential
Uso Pratico:
โข Calcola quante fibre necessarie per traffic forecast
โข Esempio: serve 20 Tbps? โ Minimo 3 fibre @ 8Tbps (con margin)
๐ฌ Procedura: Verifica Fattibilitร Nuovo Collegamento
Input: Due centrali A e B da connettere
Step 1: Misura distanza aerea con ruler tool
Step 2: Usa "Centrali Vicine" per distanza stradale
Step 3: Calcola rapporto stradale/aerea (ideale <1.3)
Step 4: Se >1.5 โ verifica percorso: possibili ostacoli (montagne, proprietร private)
Step 5: Calcola latency teorica (distanza_aerea/200.000ร1000)
Step 6: Calcola link budget (formula attenuazione sopra)
Step 7: Se budget >30dB โ necessari amplificatori โ costo aumenta
Output: GO/NO-GO tecnico + stima complessitร
๐ Procedura: Troubleshooting Collegamento Degradato
Sintomo: Alta latency o packet loss su link esistente
Step 1: Identifica link in tabella Collegamenti
Step 2: Click per zoom e visualizzazione
Step 3: Verifica distanza dichiarata vs misurata (should match)
Step 4: Se mismatch โ possibile errore configurazione routing
Step 5: Controlla stato: se IN_VARIAZIONE โ lavori in corso
Step 6: Usa "Centrali Vicine" per trovare bypass temporaneo
Step 7: Misura distanza bypass con ruler
Step 8: Valuta se latency aggiuntiva รจ accettabile per SLA
Output: Piano di mitigazione
Conversioni Distanza:
โข 1 km = 0.621371 miles
โข 1 mile = 1.60934 km
Conversioni Coordinate:
โข 1 grado latitudine โ 111 km
โข 1 grado longitudine โ 111 km ร cos(latitudine)
โข 1' (arc minute) โ 1.852 km
โข 1" (arc second) โ 30.9 metri
Costanti Fibra:
โข Velocitร luce vuoto: 299.792.458 m/s
โข Velocitร fibra SMF: ~200.000 km/s
โข Attenuazione tipica @ 1550nm: 0.22 dB/km
โข Dispersione cromatica SMF: ~17 ps/(nmยทkm)
๐ก Tips Tecnici Pro:
โข Sempre verificare coordinate centrali con doppio check (Google Maps)
โข Usa DMS format per interfacce con sistemi legacy
โข Salva coordinate centrali critiche in file esterno per backup
โข Per progetti: considera 20-30% margin oltre distanza aerea per posa fibra
โข Documentare assumptions (es: ฮฑ=0.22dB/km) in calcoli link budget
Manuale pratico per tecnici che operano sul territorio per installazioni, manutenzioni e interventi su rete. Focus su operativitร e troubleshooting rapido.
1. Localizza la Centrale Target:
โข Cerca nome centrale in tabella "Centrali / Nodi"
โข Click per visualizzare posizione esatta su mappa
โข Verifica coordinate GPS (LAT/LON)
โข Copia coordinate per inserimento in navigatore
2. Identifica Collegamenti Coinvolti:
โข Filtra tabella Collegamenti per nome centrale
โข Nota tutti i link connessi a quella sede
โข Verifica quali sono ATTIVI vs quali in lavorazione
โข Stampa/salva screenshot per riferimento offline
3. Pianifica Accesso:
โข Usa "๐ข Centrali Vicine" inserendo indirizzo di partenza
โข Clicca "Mostra percorso" per routing stradale
โข Nota distanza e tempo stimato
โข Verifica se serve 4x4 per percorsi di montagna
4. Verifica Situazione Locale:
โข Zoom su centrale con livello massimo (18)
โข Osserva edifici circostanti, strade, accessi
โข Identifica parcheggio potenziale
โข Screenshot della zona per riferimento
Con Dispositivo Mobile (Tablet/Smartphone):
โข Apri NAT RC_Italia nel browser mobile
โข Concedi permessi di localizzazione al browser
โข La mappa mostra la tua posizione attuale
โข Usa "Centrali Vicine" dalla tua posizione live
โข Vedi le 3 centrali piรน prossime in real-time
Offline Fallback:
โข Pre-carica pagina NAT RC_Italia quando hai connessione
โข Mappa base rimane in cache browser
โข Dati centrali sono embedded (no richieste server)
โข Funzioni base (zoom, misura) operative offline
Conferma di Essere nel Posto Giusto:
1. Apri app GPS (es: Google Maps) sul telefono
2. Leggi coordinate attuali
3. Confronta con coordinate centrale in NAT RC_Italia
4. Se match entro 50-100 metri โ sei nel posto corretto
5. Se discrepanza >500m โ ricontrolla indirizzo
Troubleshooting Posizione Errata:
โข Possibile errore dati: segnala a coordinamento
โข Usa ricerca indirizzo inversa per verifica
โข Chiedi conferma via radio/telefono a control room
๐ ๏ธ Scenario: Attivazione Nuovo Collegamento
Task: Installare fibra tra Centrale A e Centrale B
Procedura NAT RC_Italia:
1. Cerca Centrale A in tabella
2. Cerca Centrale B in tabella
3. Verifica se collegamento giร esiste (stato: IN_ATTIVAZIONE)
4. Usa ruler tool per confermare distanza progettata
5. Clicca entrambe centrali per evidenziare posizioni
6. Zoom per verificare percorso tra le due
7. Usa "Mostra percorso" per routing stradale
8. Identifica punti critici: attraversamenti fiumi, ferrovie, autostrade
9. Documenta con screenshot per report installazione
Post-Attivazione: Segnala a coordinamento per update stato โ ATTIVO
๐จ Scenario: Intervento Urgente - Fibra Rotta
Allarme: Link ID 157 ROMA-FIRENZE down
Procedura Rapida:
1. Ricerca "157" in tabella Collegamenti
2. Click per zoom su link
3. Osserva percorso sulla mappa
4. Identifica punto medio approssimativo del tracciato
5. Usa ruler tool per misurare distanza da estremi
6. Inserisci coordinate punto medio in "Ricerca Indirizzo"
7. Clicca "Centrali Vicine" โ vedi se ci sono hub di accesso
8. Parti verso zona piรน probabile (basato su allerta)
9. Sul posto: usa OTDR per localizzare fault esatto
Comunicazione: Report posizione GPS esatta rottura a control room
๐ Scenario: Verifica Stato Post-Manutenzione
Task: Confermare collegamenti ripristinati dopo intervento
Procedura:
1. Filtra per zona di intervento (es: "RM" per Lazio)
2. Filtra per stato "IN_VARIAZIONE" (collegamenti in lavoro)
3. Identifica i link che hai lavorato oggi
4. Verifica sulla mappa che siano evidenziati
5. Controlla tabella: stato dovrebbe essere IN_VARIAZIONE โ ATTIVO
6. Se ancora IN_VARIAZIONE โ segnala a coordinator per update DB
7. Screenshot dello stato finale per chiusura ticket
Best Practice: Sempre confermare update DB entro 24h da intervento
Performance:
โข Chiudi altre app per liberare RAM
โข Usa WiFi quando disponibile (piรน veloce di 4G per OSRM routing)
โข Se lento: deseleziona "Mostra Marker Centrali" per ridurre rendering
Batteria:
โข Riduci luminositร schermo
โข Disattiva GPS quando non necessario
โข Chiudi tab browser non usati
Connettivitร :
โข Pre-carica mappa con WiFi prima di partire
โข Screenshot delle zone di lavoro per backup offline
โข Salva coordinate critiche in note del telefono
Export Coordinate per Nav Externa:
1. Click centrale target in NAT RC_Italia
2. Leggi coordinate LAT/LON dal popup o tabella
3. Copia coordinate
4. Apri Google Maps / Waze / TomTom
5. Incolla coordinate in search bar (formato: 41.9028, 12.4964)
6. App naviga verso quel punto
Formato Universale: Decimal Degrees (DD) funziona su tutte le app
Alternative: Se app richiede DMS, usa convertitore in NAT RC_Italia
Problema: "Non Trovo la Centrale X"
โข Verifica spelling: usa ricerca parziale (es: "MIL" per Milano)
โข Prova con CLLI invece di nome
โข Controlla filtri: se Area SUD attivo, centrali NORD sono nascoste
โข Reset All e riprova
Problema: "Mappa Non Si Carica"
โข Verifica connessione internet (tiles da OpenStreetMap)
โข Refresh page (F5 o pull-to-refresh su mobile)
โข Clear cache browser
โข Prova browser alternativo (Chrome vs Firefox)
Problema: "Coordinate Sembrano Sbagliate"
โข Verifica formato: LAT deve essere ~37-47 per Italia
โข LON deve essere ~7-18 per Italia
โข Se LAT/LON invertiti: swap manualmente
โข Se coordinate tipo "N 41ยฐ 54' 10"" โ convert to DD first
Problema: "Percorso Stradale Non Disponibile"
โข OSRM potrebbe essere offline (temporaneo)
โข Fallback: usa distanza aerea ร 1.3 come stima
โข Usa Google Maps routing come alternativa
โข Report issue a team sviluppo
๐ก Tips Tecnici da Campo:
โข Sempre porta power bank per device
โข Screenshot critici prima di perdere segnale
โข Coordinate centrali critiche in notepad paper come backup
โข Testa percorso in NAT RC_Italia la sera prima
โข Se dubbio su posizione, chiama control room PRIMA di scavare!
Tutorial completo di tutte le funzionalitร dello strumento con istruzioni dettagliate passo-passo.
Posizione: Pannello sinistro, sezione "๐ฆ Filtra per Stato"
Funzione: Controlla visibilitร collegamenti in base allo stato operativo. Ogni stato ha checkbox indipendente.
๐ก Caso d'uso pratico:
Obiettivo: Vedere solo collegamenti che richiedono attenzione
Azione: Deseleziona "ATTIVO" โ rimangono visibili solo link con stati non-standard
Risultato: Focus immediato su collegamenti in lavorazione o problematici
Posizione: Pannello sinistro, sezione "๐๏ธ Filtra per Area"
Funzione: Controllo visibilitร per macro-aree geografiche. Filtra sia nodi che collegamenti.
๐ก Workflow Report Regionale:
1. Deseleziona tutte le aree tranne quella di interesse (es: solo SUD)
2. Click "๐บ๏ธ Zoom All" per vista ottimale dell'area
3. Osserva densitร collegamenti e copertura centrali
4. Screenshot per report
5. Ripeti per altre aree se necessario
Posizione: Pannello sinistro, sezione "๐ฒ Filtra per Zona"
Funzione: Filtro piรน fine per singole regioni o zone amministrative. 14 zone disponibili.
NORD: PV (Piemonte/VdA) โข LO (Lombardia) โข LI (Liguria) โข NE (Nord-Est) โข ER (Emilia Romagna)
CENTRO: TO (Toscana) โข MU (Marche/Umbria) โข RM (Lazio) โข AM (Abruzzo/Molise)
SUD: CB (Campania/Basilicata) โข SA (Sardegna) โข PU (Puglia) โข CA (Calabria) โข SI (Sicilia)
๐ก Selezione Negativa Avanzata:
Obiettivo: Vedere tutto tranne Sardegna e Sicilia (isole)
Metodo:
1. Click "Tutti" per selezionare tutto
2. Deseleziona SA (Sardegna)
3. Deseleziona SI (Sicilia)
4. Risultato: Solo Italia continentale visibile
Posizione: Pannello sinistro, sezione "๐ฏ Filtra per Arco"
Funzione: Filtro per segmenti di rete specifici (es: backbone, anelli metropolitani, collegamenti transnazionali).
Concetto: Gli archi rappresentano raggruppamenti logici di collegamenti per scopo infrastrutturale.
Esempi Tipici:
โข Arco_Dorsale_Nord: Collegamenti backbone area settentrionale
โข Arco_Anello_RM: Anello metropolitano Roma
โข Arco_Interconnessione_EU: Link transfrontalieri
Numero Archi: Variabile (dipende da architettura rete)
1. Espandi lista archi disponibili
2. Seleziona/deseleziona checkbox per arco specifico
3. Solo collegamenti appartenenti ad archi selezionati sono visibili
4. Usa "Tutti"/"Nessuno" per controllo rapido
Combinazione con Altri Filtri: Arco + Stato + Area = filtro ultra-specifico
Posizione: Pannello sinistro, sezione "๐ Collegamenti (Selezionabili e Sempre Visibili)"
Funzione: Lista scrollabile di tutti i collegamenti con ricerca e selezione.
Linea 1: ID โ Centrale A โ Centrale B โ (se selezionato)
Linea 2: Distanza km โข Zona โข Regione โข Stato
Colorazione Stato:
โข Verde = ATTIVO
โข Rosso = NON_ATTIVO
โข Giallo = IN_ATTIVAZIONE
โข Arancione = IN_VARIAZIONE
โข Blu = IN_REINSTRADAMENTO
Click su Collegamento: Seleziona/deseleziona + zoom automatico sull'area
Evidenziazione Selezione: Sfondo azzurro + bordo sinistro blu
Ricerca: Digita testo โ lista filtra istantaneamente
Ricerca Avanzata (Modalitร Blocco): Digita piรน ID separati da virgola/punto e virgola
Esempio: "105, 157, 203" โ mostra solo questi 3 collegamenti
๐ก Workflow Selezione Multipla:
1. Filtra per zona (es: RM per Lazio)
2. Filtra per stato (es: solo ATTIVO)
3. Click "Tutti" nella tabella Collegamenti (con finestra di conferma) โ seleziona tutti i match
4. Click "Select" (azzurro) โ vedi solo quelli selezionati
5. Click "๐ Zoom Selezione" โ mappa si centra su subset
Risultato: Vista focalizzata su collegamenti attivi nel Lazio
Posizione: Pannello sinistro, sezione "๐ Centrali / Nodi (Selezionabili e Sempre Visibili)"
Funzione: Lista delle 124 centrali con ricerca, selezione e zoom automatico.
Linea 1: Nome Centrale โ (se selezionata)
Linea 2: CLLI โข Lat XX.XXXX โข Lon YY.YYYY
Evidenziazione: Se selezionata โ sfondo rosa + bordo rosso
Click su Centrale: Seleziona/deseleziona + map pan/zoom su quella sede
Zoom Automatico: Livello 10 su centrale selezionata
Evidenziazione Collegamenti: Tutti i link connessi a quella centrale si evidenziano
Ricerca Multipla: Digita parte di nome comune (es: "ROMA") โ vedi tutte centrali con "ROMA" nel nome
๐ก Trova Tutte Centrali in una Cittร :
Obiettivo: Vedere tutte le sedi a Milano
Metodo:
1. Campo ricerca Centrali: digita "MILANO"
2. Lista mostra solo match (es: MILANO_NORD, MILANO_SUD, MILANO_CENTRO)
3. Click "Tutti" per selezionarle tutte
4. Click "๐ Zoom Selezione" โ mappa centra su area metropolitana Milano
5. Osserva visivamente tutti link interconnessi tra sedi milanesi
Posizione: Barra controlli in alto a sinistra sulla mappa
Funzione: Incrementa/decrementa livello zoom (1-18)
Equivalente: Scroll wheel mouse / pinch-to-zoom touch
Livelli Utili:
โข Zoom 6: Vista Italia completa
โข Zoom 10: Regione/provincia
โข Zoom 14: Cittร dettaglio
โข Zoom 18: Livello strada singolo edificio
Funzione: Torna istantaneamente a vista default
Parametri Reset:
โข Centro: LAT 41.887, LON 12.549 (Centro Italia)
โข Zoom: Livello 6
Quando Usare: Se ti sei perso in zoom profondo e vuoi tornare a overview nazionale
Funzione: Attiva modalitร misura distanze
Procedura:
1. Click icona ๐
2. Click primo punto su mappa
3. Click secondo punto
4. Appare linea rossa tratteggiata con distanza
5. Opzionale: continua click per misura multi-segmento
Precisione: Calcolo Haversine (ยฑ0.5%)
Unitร : Kilometri (km) con 2 decimali
Funzione: Rimuove tutti i segmenti di misura dalla mappa
Effetto: Istantaneo, non reversibile (no undo)
Nota: Non cancella collegamenti o nodi, solo misure manuali
Posizione: Solitamente in fondo al pannello sinistro (scroll down necessario)
Funzione: Auto-zoom su elementi correntemente selezionati
Algoritmo: Calcola bounding box di tutti nodi/link selezionati, poi fit map
Padding: Automatico 50px per evitare elementi ai bordi
Quando Usare: Dopo selezione multipla per focus area
Prerequisito: Almeno 1 collegamento o centrale deve essere selezionato
Funzione: Auto-zoom su TUTTI elementi visibili (rispetta filtri)
Differenza vs Zoom Selezione: Ignora selezione, usa visibilitร
Esempio Uso:
โข Filtri attivi: Area SUD + Stato ATTIVO
โข Click "Zoom All"
โข Risultato: Mappa si adatta per mostrare tutto il SUD con link attivi
Tip: Combina con filtri per viste personalizzate rapidamente
Funzione: Reset completo interfaccia a stato default
Cosa Viene Resettato:
โข โ
Tutti filtri Stato โ tutti ON
โข โ
Tutti filtri Area โ tutti ON
โข โ
Tutti filtri Zona โ tutti ON
โข โ
Filtro Arco โ tutti ON
โข โ
Selezioni collegamenti โ tutte OFF
โข โ
Selezioni centrali โ tutte OFF
โข โ
Campo ricerca Collegamenti โ vuoto
โข โ
Campo ricerca Centrali โ vuoto
โข โ
Misure sulla mappa โ cancellate
โข โ
Vista mappa โ Italia centro zoom 6
โข โ
Marker geocoding โ rimosso
โข โ
Percorsi stradali visualizzati โ cancellati
โ ๏ธ NON Resettato: Preferenze browser, history, bookmark
Best Practice: Usa Reset All all'inizio di ogni nuova sessione di lavoro
Posizione: Pannello sulla mappa (solitamente floating box in alto a sinistra)
Input: Indirizzo testuale (strada, cittร , CAP, landmark)
Engine: Nominatim (OpenStreetMap)
Procedura:
1. Click campo "Ricerca Indirizzo"
2. Digita indirizzo (es: "Via Roma 10, Milano")
3. Premi Enter o click ๐
4. Mappa si centra su indirizzo trovato
5. Marker rosso appare sul punto
6. Coordinate nei campi LAT/LON si aggiornano
Tips per Risultati Migliori:
โข Includi sempre cittร : "Piazza Duomo, Milano" meglio di solo "Piazza Duomo"
โข Usa CAP per disambiguare: "Via Roma, 20100 Milano"
โข Landmark famosi funzionano: "Colosseo Roma", "Torre di Pisa"
Limitazioni:
โข Indirizzi molto nuovi potrebbero non essere nel DB OSM
โข Zone rurali hanno copertura minore
โข Formattazione italiana richiesta (no indirizzi US-style)
Input: LAT e LON numerici
Formato: Decimal Degrees (DD) - esempio: 45.4642, 9.1900
Procedura:
1. Click campo LAT
2. Inserisci latitudine (range valido Italia: ~36 to ~47)
3. Click campo LON
4. Inserisci longitudine (range valido Italia: ~6 to ~19)
5. Click โค (freccia) o premi Enter
6. Mappa si centra su coordinate
7. Marker rosso appare
Precisione:
โข 4 decimali: ยฑ11 metri
โข 5 decimali: ยฑ1.1 metri
โข 6 decimali: ยฑ11 cm
Validazione:
โข LAT fuori range โ errore o default a centro Italia
โข LON fuori range โ errore
โข Formato errato (es: lettere) โ ignore o default
Funzione: Campo "Ricerca Indirizzo" mostra sempre coordinate centro mappa
Aggiornamento: Real-time mentre trascini/panori la mappa
Uso:
โข Sposta mappa su punto di interesse
โข Leggi coordinate nel campo
โข Copia per uso in altri tool (GPS, GIS, etc.)
Formato Display: "LAT: XX.XXXXXX, LON: YY.YYYYYY"
Pulsante: "๐ข Centrali Vicine" (appare sotto il campo Ricerca Indirizzo)
Prerequisito: Deve esserci un marker rosso sulla mappa (da geocoding o coordinate)
๐ Workflow Completo Passo-Passo:
Passo 1: Definisci Posizione di Partenza
โข Opzione A: Digita indirizzo in "Ricerca Indirizzo" + Enter
โข Opzione B: Inserisci coordinate LAT/LON + click โค
โ Risultato: Marker rosso appare su mappa
Passo 2: Avvia Ricerca
โข Click pulsante "๐ข Centrali Vicine"
โข Attendi 1-2 secondi (calcolo distanze in corso)
โ Risultato: Pannello popup con 3 risultati
Passo 3: Analizza Risultati
โข Per ogni centrale vedi:
- Nome e CLLI
- Distanza aerea in km (linea rossa tratteggiata)
- Link "Mostra percorso" per routing stradale
โ Risultato: Top 3 centrali ordinate per distanza crescente
Passo 4: Visualizza Percorso Stradale
โข Click "Mostra percorso" su centrale scelta
โข Attendi 2-3 secondi (query OSRM)
โ Risultato: Linea blu continua appare su mappa
Passo 5: Leggi Dettagli Distanze
โข Click su linea rossa (distanza aerea) โ popup con km
โข Click su linea blu (percorso stradale) โ popup con km stradali
โ Risultato: Confronto diretto aerea vs stradale
Passo 6: Valuta e Decidi
โข Calcola rapporto stradale/aerea
โข Se <1.3 โ percorso diretto, fattibile
โข Se >1.5 โ percorso tortuoso, possibili ostacoli
โ Risultato: Decision support per feasibility
Step 1: Calcola distanza Haversine da punto query a tutte le 124 centrali
Step 2: Sort centrali per distanza crescente
Step 3: Prendi top 3
Step 4: Per ogni top 3, query OSRM per routing stradale
Step 5: Display risultati con dual metric (aerea + stradale)
Performance: ~1-2 secondi totali su connessione media
Fallback: Se OSRM fail, mostra solo distanza aerea
Distanza Aerea (Linea Rossa Tratteggiata):
โข Rappresenta shortest path "as the crow flies"
โข Utile per: calcolo latenza fibra, rough estimate costi
โข Limitazione: Ignora ostacoli (montagne, fiumi, proprietร private)
Distanza Stradale (Linea Blu Continua):
โข Rappresenta percorso effettivo con strade reali
โข Utile per: logistica installazione, tempo viaggio tecnici
โข Include: curve, salite, limiti velocitร stradali
Rapporto Stradale/Aerea (Indice di Tortuositร ):
โข <1.2: Percorso quasi rettilineo (ideale)
โข 1.2-1.4: Percorso ragionevole (normale)
โข 1.4-1.6: Percorso tortuoso (attenzione)
โข >1.6: Percorso molto tortuoso (problematico, possibili ostacoli significativi)
๐ก Pro Tips Centrali Vicine:
โข Ripeti ricerca da posizioni diverse per coverage analysis
โข Screenshot risultati per documentazione progetto
โข Se top 3 tutte >50km โ identificato gap di coverage
โข Usa in combo con filtro Zona per focus regionale
โข Per installazioni: considera sempre percorso stradale, non aerea
Posizione: Checkboxes solitamente sotto la mappa o nel pannello controlli
Funzione: Toggle visibilitร dei marker circolari sulle centrali
Default: ON (marker visibili)
Quando Disattivare:
โข Mappa troppo affollata con 124 marker
โข Performance lenta (device vecchi)
โข Focus solo su collegamenti, non su nodi
Effetto OFF: Centrali spariscono visualmente, ma collegamenti rimangono
Funzione: Toggle visibilitร collegamenti non selezionati
Default: ON (tutti collegamenti visibili)
Quando Disattivare:
โข Hai selezionato subset specifico e vuoi focus SOLO su quello
โข Ridurre clutter visivo
Effetto OFF: Solo collegamenti selezionati (con โ) rimangono visibili
Combinazione Potente: OFF + "Select" nella tabella = vista ultra-pulita
Funzione: Quando selezioni collegamenti, evidenzia automaticamente nodi terminali
Default: Dipende da implementazione (solitamente ON)
Effetto ON: Centrali agli estremi di link selezionati cambiano colore/dimensione
Uso: Visualizzazione rapida topologia: quali nodi sono hub critici
Nota: Non seleziona i nodi nella tabella Centrali, solo evidenziazione visiva
โ
Fix 05/12/2025: Ora funziona correttamente con tutti i database (DB RC, DB RA, DB RA+RC)
Posizione: Floating panel in basso a destra della mappa
Funzione: Mostra coordinate real-time del cursore mouse sulla mappa
Formato DD (Decimal Degrees):
โข Lat: XX.XXXXXXยฐ
โข Lon: YY.YYYYYYยฐ
Formato DMS (Degrees Minutes Seconds):
โข Lat: XXยฐ YY' ZZ" N/S
โข Lon: XXยฐ YY' ZZ" E/W
Aggiornamento: Real-time seguendo mouse
Precisione: 6 decimali (ยฑ11 cm)
Identificazione Rapida Posizione:
โข Muovi mouse su punto di interesse
โข Leggi coordinate istantaneamente
โข No need per click o geocoding
Export Coordinate:
โข Hover su punto
โข Leggi coordinate nel tracker
โข Scrivi manualmente o screenshot
Verifica Centrali:
โข Hover su marker centrale
โข Controlla coordinate nel tracker
โข Confronta con valori in tabella Centrali
๐ Golden Rules per Uso Efficace:
1. Sempre "Reset All" All'Inizio
โข Evita confusione da filtri/selezioni sessioni precedenti
โข Baseline pulita = analisi affidabile
2. Combina Filtri Strategicamente
โข Esempio: Area SUD + Stato ATTIVO + Zona SA = tutti link attivi in Sardegna
โข Piรน filtri = piรน precisione
3. Usa "Select" per Focus
โข Seleziona subset interessante
โข Click "Select" (azzurro) in tabella
โข Vista pulita solo su ciรฒ che conta
4. Screenshot per Documentazione
โข Mappe con filtri applicati = instant report
โข Include timestamp e descrizione filtri
5. Verifica Coordinate con Doppio Check
โข NAT RC_Italia + Google Maps = massima affidabilitร
โข Centrale critica? Verifica posizione su due fonti
6. Mobile: Pre-Carica Prima di Uscire
โข Apri tool con WiFi
โข Mappa tiles in cache
โข Screenshot zone lavoro
7. Salva Lavoro Frequentemente
โข Browser puรฒ crashare
โข No auto-save: screenshot o note esterne
8. Coordinate per GIS: Usa DD
โข Decimal Degrees = formato universale
โข Import diretto in QGIS, ArcGIS, Google Earth
9. Distanze: Aerea per Latenza, Stradale per Logistica
โข Calcoli tecnici โ distanza aerea
โข Planning installazione โ distanza stradale
10. Report al Team: Condividi URL
โข URL con filtri applicati puรฒ essere condiviso
โข Team vede stessa vista
โข Collaborazione facilitata
Problema: Tool Lento
โ Disattiva "Mostra Marker Centrali"
โ Chiudi altre tab browser
โ Usa Chrome/Firefox (no IE/Edge vecchi)
Problema: Mappa Non Si Carica
โ Verifica connessione internet
โ Refresh page (F5)
โ Clear cache browser
Problema: Coordinate Sbagliate
โ Verifica formato: LAT deve essere ~36-47, LON ~6-19 per Italia
โ Se invertiti: swap manualmente
โ Confronta con Google Maps
Problema: Percorso Stradale Non Appare
โ OSRM potrebbe essere temporaneamente offline
โ Attendi 30 sec e riprova
โ Fallback: usa distanza aerea ร 1.3 come stima
Problema: Non Trovo Collegamento X
โ Verifica filtri attivi (Area, Zona, Stato, Arco)
โ Click "Reset All" e riprova
โ Cerca per ID numerico invece di nomi
Problema: Select (Azzurro) Non Funziona
โ Verifica di aver selezionato almeno 1 elemento prima
โ Deseleziona tutto e riprova
โ Refresh page se persiste
๐ก Ultimo Consiglio Professionale:
Questo tool รจ potente quanto sai usarlo. Investi 30 minuti esplorando tutte le funzioni con dati reali. Prova combinazioni di filtri assurde, rompi cose, fai errori. L'unico modo per padroneggiare uno strumento รจ sporcarsi le mani. Buon lavoro! ๐
Guida completa per l'aggiornamento dei database RC e RA dell'applicazione NAT Italia. La procedura prevede due blocchi separati di aggiornamento per garantire integritร e tracciabilitร .
โ ๏ธ IMPORTANTE - Aggiornamento in Due Blocchi
I database vengono aggiornati separatamente per garantire:
โข โ
Tracciabilitร delle modifiche per singola rete
โข โ
Rollback selettivo in caso di problemi
โข โ
Validazione indipendente dei dati
โข โ
Continuitร del servizio durante l'update
DB RC (Backbone):
โข RC_Italia_Nodes.xlsx - Centrali rete backbone
โข RC_Italia_Links.xlsx - Collegamenti rete backbone
DB RA (Access):
โข RA_Italia_Nodes.xlsx - Centrali rete accesso
โข RA_Italia_Links.xlsx - Collegamenti rete accesso
Generati dalla conversione:
โข db1_nodes.json - Nodi RC (backbone)
โข db1_links.json - Link RC (backbone)
โข db2_nodes.json - Nodi RA (access)
โข db2_links.json - Link RA (access)
Nomenclatura:
โข DB1 = RC Italia (Backbone/Core)
โข DB2 = RA Italia (Access/Aggregation)
๐ Step-by-Step DB RC
STEP 1 - Preparazione Excel RC
1. Apri il file RC_Italia_Nodes.xlsx
2. Verifica/aggiorna i seguenti campi obbligatori:
โข id: Identificativo univoco centrale
โข name: Nome descrittivo centrale
โข clli: Codice CLLI (8-11 caratteri)
โข lat: Latitudine (formato DD, es: 41.902784)
โข lon: Longitudine (formato DD, es: 12.496366)
โข zona: Codice zona 2 lettere (es: RM, LO, CB)
โข region: Nome regione esteso
3. Salva il file Excel
STEP 2 - Preparazione Links RC
1. Apri il file RC_Italia_Links.xlsx
2. Verifica/aggiorna i campi:
โข id: ID collegamento
โข from: CLLI centrale origine
โข to: CLLI centrale destinazione
โข distance: Distanza in km
โข state: Stato operativo
โข zona: Zona di appartenenza
โข arco: Arco di rete (opzionale)
3. Salva il file Excel
STEP 3 - Conversione JSON
1. Esegui lo script di conversione Python:
python convert_excel_to_json.py --db RC
2. Verifica output: db1_nodes.json e db1_links.json
3. Controlla console per errori di validazione
STEP 4 - Integrazione HTML
1. Apri il file HTML dell'applicazione
2. Cerca la sezione // === DATABASE RC (DB1) ===
3. Sostituisci il contenuto JSON dei nodi e link
4. Salva il file HTML
STEP 5 - Validazione
1. Apri l'applicazione nel browser
2. Seleziona "๐ DB RC" (bottone rosso)
3. Verifica contatori: nodi e collegamenti
4. Test visivo su mappa
5. Test ricerca centrali
๐ Step-by-Step DB RA
STEP 1 - Preparazione Excel RA
1. Apri il file RA_Italia_Nodes.xlsx
2. Verifica/aggiorna i campi (stessi di RC):
โข id, name, clli, lat, lon, zona, region
3. Salva il file Excel
STEP 2 - Preparazione Links RA
1. Apri il file RA_Italia_Links.xlsx
2. Verifica/aggiorna i campi (stessi di RC)
3. Salva il file Excel
STEP 3 - Conversione JSON
1. Esegui lo script di conversione:
python convert_excel_to_json.py --db RA
2. Verifica output: db2_nodes.json e db2_links.json
STEP 4 - Integrazione HTML
1. Cerca la sezione // === DATABASE RA (DB2) ===
2. Sostituisci il contenuto JSON
3. Salva il file HTML
STEP 5 - Validazione
1. Seleziona "๐ DB RA" (bottone blu)
2. Verifica contatori
3. Test mappa e ricerca
1. Verifica DB MERGED:
โข Clicca "๐ DB RA+RC" (bottone viola)
โข Verifica che contatori siano somma logica dei due DB
โข Controlla che nodi duplicati abbiano _source: 'BOTH'
2. Test Etichette Tipo Rete:
โข Usa "๐ข Centrali Vicine" in modalitร MERGED
โข Verifica che le etichette mostrino correttamente:
โข RC_Italia Core per centrali solo RC
โข RA_Italia Aggregation per centrali solo RA
โข Aggregation โข Core per centrali in entrambi
3. Test Funzionalitร :
โข Filtri per zona/area
โข Selezione collegamenti
โข Zoom e navigazione mappa
โข Calcolo percorsi stradali
Problema: Coordinate non valide
โ Verifica formato: LAT 36-47, LON 6-19 per Italia
โ Usa punto decimale, non virgola
โ Rimuovi spazi extra
Problema: CLLI duplicati
โ Ogni CLLI deve essere univoco nel DB
โ Controlla con formula Excel: =COUNTIF(A:A,A2)>1
Problema: Link orfani
โ Verifica che FROM e TO esistano nella lista nodi
โ Case-sensitive: "RMCNTL01" โ "rmcntl01"
Problema: JSON malformato
โ Usa validatore JSON online
โ Controlla virgole finali e parentesi
โ Encoding UTF-8 senza BOM
Problema: Mappa vuota dopo update
โ Apri Console Browser (F12)
โ Cerca errori JavaScript rossi
โ Verifica che arrays non siano vuoti
๐ก Best Practice Update Database:
โข Backup SEMPRE prima di ogni modifica
โข Versioning: nomina file con data (es: NAT_Rev17_5_2025-12-05.html)
โข Test incrementale: aggiorna un DB alla volta
โข Documenta: annota modifiche effettuate
โข Ambiente staging: testa su copia prima di produzione
{
"id": "CENTRALE_001",
"name": "Milano Centrale",
"clli": "MLNOITXA",
"lat": 45.4642,
"lon": 9.1900,
"zona": "LO",
"region": "Lombardia"
}
{
"id": "LINK_001",
"from": "MLNOITXA",
"to": "RMCNTLXA",
"distance": 573.2,
"state": "ATTIVO",
"zona": "LO",
"region": "Lombardia",
"arco": "Dorsale_Nord_Sud"
}
๐ Supporto Tecnico
Per problemi durante l'aggiornamento database:
โข Verifica questa guida passo-passo
โข Controlla console browser per errori
โข Confronta con backup funzionante
โข Contatta il team di sviluppo con log errori